```python
{{#if readmeSnippet}}
{{{readmeSnippet}}}
{{else}}
    {{#with apiInfo}}
        {{#if hasTopLevelOperations}}
            {{#with topLevelOperations.0}}
{{> api_doc_example_setup}}
            {{/with}}
            {{#each topLevelOperations}}

{{> api_doc_example_execute}}
            {{/each}}
        {{else}}
            {{#each apis}}
                {{#if @first}}
                    {{#with operations}}
                        {{#each operation}}
                            {{#if @first}}
{{> api_doc_example pydantic=prstv2}}
                            {{/if}}
                        {{/each}}
                    {{/with}}
                {{/if}}
            {{/each}}
        {{/if}}
    {{/with}}
{{/if}}
```

## Async

`async` support is available by prepending `a` to any method.

```python
{{#if asyncReadmeSnippet}}
{{{asyncReadmeSnippet}}}
{{else}}
{{#with apiInfo}}
{{#each apis}}
{{#if @first}}
{{#with operations}}
{{#each operation}}
{{#if @first}}

import asyncio
{{> api_doc_example_setup}}

async def main():
    {{> api_doc_example_execute pydantic=prstv2 async=true}}

asyncio.run(main())
{{/if}}
{{/each}}
{{/with}}
{{/if}}
{{/each}}
{{/with}}
{{/if}}
```
{{#if prstv2}}

## Raw HTTP Response

To access raw HTTP response values, use the `.raw` namespace.

```python
{{#with apiInfo}}
{{#each apis}}
{{#if @first}}
{{#with operations}}
{{#each operation}}
{{#if @first}}
{{> api_doc_example raw=true}}
{{/if}}
{{/each}}
{{/with}}
{{/if}}
{{/each}}
{{/with}}
```
{{/if}}

{{#if readmeSupportingDescriptionSnippet}}

{{{readmeSupportingDescriptionSnippet}}}
{{/if}}
{{#unless omitApiDocumentation}}

## Reference
{{#with apiInfo}}
{{#each apis}}
{{#with operations}}
{{#each operation}}
### `{{clientNameLowercase}}.{{> api_doc_example_method}}`
{{#isDeprecated}}
![Deprecated](https://img.shields.io/badge/deprecated-yellow)
{{/isDeprecated}}

{{#if notes}}
{{{unescapedNotes}}}

{{/if}}
{{#unless notes}}
{{{summary}}}

{{/unless}}
#### 🛠️ Usage

```python
{{> api_doc_example_execute_call}}
```

{{#if hasParams}}
{{#each allParamsWithRequestBodyProperties}}
{{#if @first}}
#### ⚙️ Parameters

{{/if}}
{{#if operationVendorExtensions.x-konfig-operation-can-have-single-parameter}}
##### {{paramName}}: {{> api_doc_param_data_type}}

{{> README_parameter_description}}
{{else}}
{{#unless isFromBodyParam}}
##### {{paramName}}: {{> api_doc_param_data_type}}

{{> README_parameter_description}}
{{/unless}}
{{/if}}
{{/each}}
{{#with bodyParam}}
{{#unless operationVendorExtensions.x-konfig-operation-can-have-single-parameter}}
##### requestBody: {{> api_doc_param_data_type}}

{{> README_parameter_description}}
{{else}}
#### ⚙️ Request Body

{{> api_doc_param_data_type}}

{{> README_parameter_description}}
{{/unless}}
{{/with}}
{{/if}}
{{#with returnModel}}
#### 🔄 Return

{{#if prstv2}}
[`{{{classname}}}`](./{{packageName}}/pydantic/{{classFilename}}.py)
{{else}}
[`{{{classname}}}`](./{{packageName}}/type/{{classFilename}}.py)
{{/if}}

{{/with}}
#### 🌐 Endpoint

`{{path}}` `{{httpMethod}}`

[🔙 **Back to Table of Contents**](#table-of-contents)

---

{{/each}}
{{/with}}
{{/each}}
{{/with}}
{{/unless}}

{{#unless removeKonfigBranding}}
## Author
This Python package is automatically generated by [Konfig](https://konfigthis.com)
{{/unless}}
